📄 📖 夜航船 2026-04-11T00:00:00.000Z

Hermes Agent快速参考卡

参考快速查阅 Hermes 命令手册

Hermes Agent 快速参考卡

📦 安装命令

# 一键安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 重新加载shell
source ~/.bashrc

# 验证安装
hermes version
hermes doctor

🔧 配置命令

模型配置

# 交互式配置
hermes model

# 添加提供商
hermes model add <provider> \
  --base-url <url> \
  --api-key <key> \
  --model <model-id>

# 查看模型
hermes model list

# 测试模型
hermes model probe

# 切换模型
hermes config set model.default <model-id>

飞书配置

# 交互式配置（推荐）
hermes gateway setup

# 命令行配置
hermes config set channels.feishu.enabled true
hermes config set channels.feishu.app_id <app-id>
hermes config set channels.feishu.app_secret <secret>
hermes config set channels.feishu.connection_mode websocket

YOLO模式

# 开启YOLO
hermes config set yolo.enabled true

# 关闭YOLO
hermes config set yolo.enabled false

# 查看状态
hermes config get yolo.enabled

🔄 迁移命令

# 预览迁移
hermes claw migrate --source ~/.openclaw --dry-run

# 执行迁移
hermes claw migrate --source ~/.openclaw --migrate-secrets -y

# 仅迁移用户数据
hermes claw migrate --source ~/.openclaw --preset user-data -y

# 清理
hermes claw cleanup

🚀 服务管理

Gateway控制

# 启动
hermes gateway start

# 停止
hermes gateway stop

# 重启
hermes gateway restart

# 查看状态
hermes gateway status

# 查看日志
hermes gateway logs

# 测试连接
hermes gateway probe feishu

Systemd服务（开机自启）

# 启用
sudo systemctl enable hermes-gateway.service

# 启动
sudo systemctl start hermes-gateway.service

# 停止
sudo systemctl stop hermes-gateway.service

# 重启
sudo systemctl restart hermes-gateway.service

# 查看状态
systemctl status hermes-gateway.service

# 查看日志
journalctl -u hermes-gateway -f

🔍 诊断命令

# 版本检查
hermes version

# 完整诊断
hermes doctor

# 配置检查
hermes config check

# 查看配置
hermes config

# 编辑配置
hermes config edit

💬 对话命令

# 开始交互式对话
hermes

# 单次查询
hermes chat -q "你好"

# 指定模型
hermes chat -q "测试" --model glm-5

# 测试模式（不执行）
hermes chat -q "测试" --dry-run

📝 记忆管理

# 查看记忆列表
hermes memory list

# 搜索记忆
hermes memory search <关键词>

# 添加记忆
hermes memory add "重要信息"

# 清除记忆
hermes memory clear

🛠️ Skills管理

# 查看skills
hermes skills list

# 安装skill
hermes skills install <skill-name>

# 更新skill
hermes skills update <skill-name>

📁 重要文件位置

文件	路径
配置文件	`~/.hermes/config.yaml`
环境变量	`~/.hermes/.env`
记忆目录	`~/.hermes/memories/`
技能目录	`~/.hermes/skills/`
日志目录	`~/.hermes/logs/`
Gateway状态	`~/.hermes/gateway_state.json`

🆘 故障排查

常见问题

# 1. 命令找不到
source ~/.bashrc

# 2. 查看错误日志
grep -i error ~/.hermes/logs/gateway.log

# 3. 查看连接状态
cat ~/.hermes/gateway_state.json

# 4. 测试飞书连接
hermes gateway probe feishu

# 5. 重启Gateway
pkill -f "hermes gateway"
hermes gateway start

日志查看

# 实时日志
tail -f ~/.hermes/logs/gateway.log

# 最近50行
tail -50 ~/.hermes/logs/gateway.log

# 错误日志
grep -i error ~/.hermes/logs/gateway.log

# Systemd日志
journalctl -u hermes-gateway -f

📊 监控命令

# 内存使用
ps aux | grep hermes | awk '{print $6/1024 " MB"}'

# CPU使用
top -p $(pgrep -f "hermes gateway")

# 进程状态
ps aux | grep hermes

# 服务状态
systemctl status hermes-gateway

# Gateway状态
hermes gateway status

🔄 回滚命令

# 快速回滚到OpenClaw
pkill -f "hermes gateway"
openclaw gateway start

# 完全卸载Hermes
pkill -f hermes
rm -rf ~/.hermes
sudo systemctl disable hermes-gateway.service
sudo rm /etc/systemd/system/hermes-gateway.service

📚 参考链接

资源	链接
官网	https://hermes-agent.nousresearch.com
GitHub	https://github.com/NousResearch/hermes-agent
文档	https://hermes-agent.nousresearch.com/docs/
Discord	https://discord.gg/NousResearch
Skills市场	https://agentskills.io

⚡ 快速测试流程

# 1. 安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash && source ~/.bashrc

# 2. 验证
hermes version && hermes doctor

# 3. 配置模型
hermes config set OPENAI_API_KEY <key>
hermes config set OPENAI_BASE_URL <url>
hermes config set model.default mimo-v2-omni

# 4. 测试模型
hermes model probe

# 5. 配置飞书
hermes config set FEISHU_APP_ID <app-id>
hermes config set FEISHU_APP_SECRET <secret>
hermes config set channels.feishu.enabled true

# 6. 启动Gateway
hermes gateway start

# 7. 验证连接
hermes gateway status

快速参考版本: 1.0
创建时间: 2026-04-11

归档时间: 2026-04-14
来源: /root/.openclaw/workspace-ns/hermes-quick-reference.md